home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Tampa Bay Amiga Group / TBAG - Tampa Bay Amiga Group's Disk of the Month #65 (1992)(Merlin's Software - Amiganuts United)(PD).zip / TBAG - Tampa Bay Amiga Group's Disk of the Month #65 (1992)(Merlin's Software - Amiganuts United)(PD).adf / Docs / CirclesUp.docs < prev    next >
Text File  |  1992-03-15  |  7KB  |  184 lines
  1.  
  2.                               CIRCLES UP
  3.                               ----------
  4.  
  5.                               Version 1.0
  6.    
  7.                                  By
  8.  
  9.                               Jason Lowe
  10.  
  11.  
  12.    THIS PROGRAM IS PUBLIC DOMAIN. IT MAY BE DISTRIBUTED FREELY AND MAY APPEAR
  13. IN ANY PUBLIC DOMAIN LIBRARY ON THE CONDITION THAT THIS TEXT FILE REMAIN
  14. WITH THE EXECUTABLE.  
  15.  
  16.    THIS PROGRAM USES ANDERS BJERINS EASYPLAYER TO PLAY THE SOUND FOUND IN 
  17. THIS PROGRAM. THANKS ANDERS.
  18.  
  19.  
  20.  
  21. PREFACE:
  22.  
  23. Completed:     December, 1991
  24. Language:      Lattice C v5.10a
  25. Programmer:    Jason Lowe
  26. Age:           18
  27. Computer:      A500
  28. Comments:      The concept behind this is similar to Numbers Up.
  29.  
  30.  
  31.    Any questions to do with me or my code, just write to
  32.  
  33.                            5 Collaroy Close
  34.                            Chittaway Bay
  35.                            N.S.W 2259
  36.                            Australia
  37.  
  38.    
  39.    This text file contains the following information,
  40.  
  41.    i)  How to play Circles Up.
  42.    ii) Information to programmers.
  43.  
  44.  
  45.  
  46.  
  47. i) How to play Circles Up.
  48.  
  49.    This game is designed for 2 players. Each player takes it in turn to
  50. shoot their circles up. Circles are either coloured red or green. The
  51. circles will fly in from both sides of the screen. Player 1 must shoot the
  52. red circles up. He must do this by pressing the LEFT ALT key. Player 2 must
  53. shoot the green circles up. He must do this with the RIGHT ALT key OR the
  54. left mouse button. When a circle is shoot up it will stop moving upwards
  55. either when it hits another circle or hits the border surrounding the area
  56. inwhich you shoot the circles up.
  57.  
  58.    When each player has learned to shoot the circles up it is time to
  59. connect a certain number of circles. This can be done either horizontally,
  60. vertically or diagonally. The amount of circles you need to connect is
  61. decided by you. After you have pressed "P" on the main menu you will be 
  62. presented with a question, which asks "How many circles do you need to
  63. connect?" Here you must press either 3,4,5,6 or 7. The number you press
  64. here is how many circles you need to connect whilst playing the game. Once
  65. you have pressed a number from 3 to 7 there will be a small pause, then a
  66. green circle will fly in from the left or the right side of the screen.
  67. Player 2 must shoot this circle up with the RIGHT ALT key or the left mouse
  68. button. Once Player 2 has shoot the green circle up, or let it fly past a
  69. red circle will then fly in from either the left side of the screen or the
  70. right side. Player 1 must then shoot this red circle up, or let it fly
  71. by. Circles will repeat to fly in from both sides of the screen until someone
  72. connects the right number of circles. The side that the circles fly in from
  73. will be randomly picked but the colour of the circle that flys in will be
  74. green then red then green then red etc.
  75.  
  76.    If for example you need to connect 5 circles and you manage to connect 6
  77. circles (it can be done) you will still win the game! ie you do not have to
  78. connect exactly the correct amount of circles.
  79.  
  80.    But there is still one more catch. Along with the green and red circles
  81. a blue circle will occasionally fly in. Who evers go it is will be able to
  82. shoot this blue circle up like they normally shoot their own circle up. This 
  83. blue circle has a special property. Instead of it stopping when it hits another 
  84. circle, it will simply fly thorugh all the circles and wipe them all out and 
  85. stop when it hits the border of Circles Up.
  86.  
  87.    If this game cannot load the sound it uses it will continue on with the
  88. game except it will play no sound.
  89.  
  90.    During the game, you may press ESC and the game will end and the main
  91. menu will be displayed.
  92.  
  93.    Have fun!
  94.  
  95.  
  96. ii) Information to programmers.
  97.  
  98.    Circles Up was written in Lattice C v5.10a by Jason Lowe. If there is
  99. only the main code with this program or no code at all and you would like
  100. to see all code which created Circles Up just write to me and I will gladly
  101. send it to you.
  102.  
  103.    If you have looked at the code for Circles Up you will see that it is
  104. comprised of many functions. These functions are, (in no particular order)
  105.  
  106.    - DisplayINFO
  107.    - WriteNumber
  108.    - CirclesUp
  109.    - AWinner
  110.    - how_many
  111.    - up
  112.    - up2
  113.    - ClearRASTPORT
  114.    - InitScreen
  115.    - Clearlocs
  116.    - idcmpch
  117.    - Open_Stuff
  118.    - die
  119.  
  120.    Now each of these functions explained in more detail for all you C
  121. programmers who are interested in my code.
  122.  
  123.    - DisplayINFO
  124.       This displays the information screen. It is called when the user
  125.       presses I from the main menu.
  126.  
  127.    - WriteNumber
  128.       This displays how many circles must be connected for one of the 2
  129.       users to win the game. It is called after the user has selected how
  130.       many circles they need to connect.
  131.  
  132.    - CirclesUp
  133.       This is the main program for CirclesUp. It is called when the user 
  134.       presses P from the main menu.
  135.  
  136.    - AWinner
  137.       This displays who has won the game. It is called when someone has
  138.       won.
  139.  
  140.    - how_many
  141.       This function returns the maximum number of circles found from a 
  142.       particular circle that has just been sent up. It is called directly
  143.       after a green or red circle has just been sent up.
  144.  
  145.    - up
  146.       This sends a green or a red circle upwards. It is called from the
  147.       function CirclesUp when the user has elected to shoot their circle
  148.       up at a particular location.
  149.  
  150.    -up2
  151.       This sends a blue ball up which wipes out all other balls in its
  152.       path. It is called from the function CirclesUp when the user has
  153.       elected to shoot their circle up at a particular location.
  154.  
  155.    - ClearRASTPORT
  156.       The clears the part of the rastport where the circles are drawn.
  157.    
  158.    - InitScreen
  159.       This initializes the screen. It reseeds the random number generator, 
  160.       sets all the colours correctly, loads the sound and finally draws the
  161.       main title and the borders surrounding the play area.
  162.  
  163.    - ClearLOCS
  164.       This clears all locations such that when this is called the computer 
  165.       thinks that there are no circles presently located on the screen.
  166.       This function is called when it is gameover and the screen has been
  167.       cleared.
  168.  
  169.    - idcmpch
  170.       This checks the IDCMP.
  171.  
  172.    - Open_Stuff
  173.       This opens everthing necessary for CirclesUp. It simply opens the
  174.       graphics library, intuition, a window and a screen.
  175.  
  176.    - die 
  177.       This closes everthing opened and exits.
  178.  
  179.  
  180.    I hope this has helped all C programmers interested in my code. 
  181.  
  182.    In the mean time HAPPY PROGRAMMING and COMPUTING....
  183.  
  184.